Q-circuit Tutorial 

Bryan Eastin, Steven T. Flanimia 
Department of Physics and Astronomy, University of New Mexico, Albuquerque, New Mexico 87131-1156, USA 

Q-circuit is a list of macros that greatly simplifies the construction of quantum circuit diagrams 
(QCDs) in MJ?^ with the help of the J^-pic package. This tutorial should help the reader ac- 
quire the skill to render arbitrary QCDs in a matter of minutes. Q-circuit is available for free^ at 
http://info.phys.unm.edu/Qcircuit/. 



I. INTRODUCTION 



II. GETTING STARTED 
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Ever tried to use M^riX to typeset something like this? 
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Or maybe this? 
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Typesetting quantum circuit diagrams using standard 
IMjTjX graphics packages is a difficult and time consuming 
business. Q-circuit is a high level macro package designed 
to change that. With Q-circuit, drawing quantum circuit 
diagrams is as easy as constructing an array. In a mat- 
ter of minutes you can learn the basic syntax and start 
producing circuits of your own. 

This tutorial teaches you to use Q-circuit from the 
ground up. Many readers will find that they've learned 
everything they need to know by the end of §111, but 
plenty of material is included for those that wish to type- 
set more complicated circuits. 



^The Q-circuit package is distributed under the GNU public license. 
■^ Code for these circuits is given in Appendix C. 



To install Q-circuit, place the file Qcircuit . tex some- 
where your T[t;X distribution can find it and run the ap- 
propriate command to update your T5t;X tree. To use it, 
place the command 

\input {Qcircuit }■ 

in the preamble of your document. Qcircuit .tex loads 
the amsmath and xy packages and implements a set of cir- 
cuit commands. If need be, you can obtain the necessary 
packages at http://www.ctan.org/. 



III. SIMPLE QUANTUM CIRCUITS 

To begin, suppose the reader would like to typeset the 
following simple circuit: 



— X — 



This was typeset using 

\Qcircuit @C=lem @R=.7em { 

& \gate-[X}- & \qw 
} 

The command \Qcircuit is simply a disguised 
\xymatrix command with a default parameter set. For 
readers unfamiliar with the xymatrix environment, it 
suffices to know that it behaves more or less like the 
array environment. That is, new columns are denoted 
by & and new rows by \\, as in the following example: 



a i 
1 X 



which was typeset using 



\Qcircuit @C=1.4em @R=1.2em { 

a & i \\ 

1 & X 
} 

The parameters @C=1.4em and @R=1.2ein that appear 
after \Qcircuit specify the spacing between the columns 
and the rows of the circuit, respectively. They may take 
any length as an argument. Additional parameters are 
discussed in §VA. 



A. Wires and gates 

The command \qw draws a wire between two columns 
of a QCD. The command derives its name from an ab- 
breviation of 'quantum wire'. 
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The diagram above was drawn using 

NQcircuit (2C=lem (§R=.7em i 

k \gate{H} & \gate{Z} & \gate{H} & \qw \\ 

& \qw & \gate{X} & \qw & \qw 
> 

Note that \qw is used to connect a wire towards the left. 
The \gate command draws the argument of the func- 
tion inside a framed box and extends a wire back to the 
previous column. When using the \gate and \qw com- 
mands, make sure there is another column entry to the 
left of the current column entry in your QCD. otherwise 
the wire will not connect to anything (and you'll get an 
error), as in the following example code: 

(**Wrong!**) 
NQcircuit (2C=lem (§R=.7em i 

\gate-[U> & \qw \\ 

\gate-[U-\dag} & \qw 
} 

The proper way to render this circuit would be to in- 
clude space for the incoming wires at the beginning by 
inserting the & character at the start of each new line: 



— U — 



-w - 



\[ \Qcircuit (9C=lem @R=.7em i 

k \gate{U} k \qw \\ 

k \gate{U~\dag}- k \qw 
> \] 

The only difference between these two codes is that the 
correct code has an ampersand (&) at the start of each 
new line. 



B. CNOT and other controlled single qubit gates 

With just these few commands, one can already ren- 
der a circuit with an arbitrary number of wires and sin- 
gle qubit gates. In this section, we'll learn how to draw 
CNOT gates and controlled single qubit gates with an 
arbitrary number of controls. 

A simple circuit with two CNOT gates in it is 



-^ 



-^ 



\Qcircuit @C=lem @R=.7em i 

k \ctrl{l} & \targ & \qw \\ 

k \targ k \ctrl{-l} k \qw 
} 

In this circuit, the command \targ draws the target 
gate on the wire, and the \ctrl{#l} puts a bullet down, 
and connects to the target which is #1 array elements 
below the control. Hence, to connect the second CNOT 
gate properly, we used -1. 

A more complicated circuit with multiple controls and 
arbitrary gates might look like 



^U 



-^ 



which was drawn using 

\Qcircuit @C=lem @R=.7em { 

& \ctrl{2} & \targ & \gate{U> k \qw \\ 
& \qw & \ctrl{-l} k \qw & \qw \\ 
& \targ & \ctrl{-l} k \ctrl{-2> & \qw \\ 
& \qw & \ctrl-C-l} k \qw & \qw 



In the first gate, the control bit connects to the target 
on wire 3. In the second gate, each control connects to 
the object directly above it. Finally, the third gate is an 
example of how to do controls on arbitrary gates; simply 
place the desired gate where you would normally put a 
target. 



C. Vertical wires 



Suppose we want to typeset the following circuit: 
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u. 



which was typeset by 



so that the middle control has to connect to more than 
one gate. The way to accomplish this is with the \qwx 
command. The command \qwx[#l] takes an optional 
input, #1, and connects from the current position to a 
position #1 entries below the current position. The de- 
fault argument is -1. Thus, one way to typeset the above 
diagram is with the following code: 

\Qcircuit (2C=lem @R=1.2em { 

k \gate{U_l} k \qw \\ 

k \ctrl{-l} \qwx[l] k \qw \\ 

k \gate{U_2} k \qw \\ 
} 

or, equivalently, 

\Qcircuit (2C=lem (§R=1.2em { 

k \gate{U_l} k \qw \\ 

k \ctrl{l} \qwx k \qw \\ 

k \gate{U_2} k \qw \\ 
} 



which is what the author used- 
Note that wire commands must not precede the gate 
command in an entry. Also, remember that commands 
taking an optional argument use square braces rather 
than curly braces. 



D. Labelling input and output states 

The last element we need for simple circuits is the abil- 
ity to add labels. We'll look at input and output labels 
here, other kinds of labels are discussed in §VB. 

When labelling input and output qubits, one should 
use the \lstick and \rstick commands. These com- 
mands ensure that the labels and the wires connecting to 
them line up correctly. The \lstick command is used 
for input labels (on the left of the diagram), and the 
\rstick command is used for output labels (on the right 
of the diagram) . Placement rules are the same as those 
for gates with the exception that \lstick and \rstick 
can be inserted in the leftmost column of the array. Here 
is an example circuit: 



|1) -^ |0) 
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typeset with 

\Qcircuit (2C=lem @R=lem i 
\lstick{\ket{l}} & \targ & \rstick{\ket{0}} \qw \\ 
\lstick{\ket{l}} & \ctrl{-l} & \rstick{\ket{l}} \qw 

> 



IV. MORE COMPLICATED CIRCUITS: 
MULTIPLE QUBIT GATES AND BEYOND 

So far, we have seen how to make arbitrary QCDs in- 
volving single qubit gates and controlled gates, including 
CNOT. Since this is known to be universal for compu- 
tation, we could just stop here! Of course, many circuit 
diagrams use more complicated structures such as multi- 
qubit gates, measurements, classical wires, and swaps. 
We will learn how to use Q-circuit to make all of these 
in this section. 



A. Multiple qubit gates 

Let's look at an example, and then we'll explain the 
code. 



f/t 



\qcircuit @C=lem @R=.7em -[ 

& \multigate{2}{U"\dag} & \qw \\ 

k \ghost-[U"\dag}& \qw \\ 

& \ghost-[U"\dag} & \qw 
} 

First let's go over the \multigate command. 
\multigate{#l}{#2} is a two argument gate that takes 
the depth of the gate for the first argument and the label 
of the gate for the second argument. In the above ex- 
ample, #1 equals 2 because the 3-qubit gate extends two 
rows below the position of \multigate. On the other 
two lines, the \ghost command is used to get the spacing 
and connections right, \ghost behaves like an invisible 
gate that allows the quantum wires on cither side of your 
multigate to connect correctly. 

The generalization to an arbitrarily large gate is now 
obvious. Let's look at a 6-qubit gate. The code 

\Qcircuit @C=lem @R=Oem { 

& \multigate-[5>{\mathcal-[F}} & \qw \\ 

& \ghost{\mathcal{F}} & \qw \\ 

k \ghost{\mathcal{F}} 

& \ghost{\mathcal{F}} 

& \ghost{\mathcal{F}} 

& \ghost{\mathcal{F}} 
> 

yields 



\qw \\ 
\qw \\ 
\qw \\ 
\qw 



T 



Thus, for every entry below the top, a \ghost command 
with the label for the gate is needed. Strictly speaking, 
the name of the gate is not necessary inside the \ghost 
command. Since \ghost is just an invisible place holder, 
anything with the same width as the label specified in 
multigate will work as well. In practice, however, it is 
usually easiest to use the same argument. 

Note that controls to multiple qubit gates work the 
same as for single qubit gates, using \ctrl and \qwx. 



B. Measurements and classical bits 

Measurement gates are typeset just like ordinary gates, 
but they typically have some sort of decoration to in- 
dicate that measurement has occurred. At present, Q- 
circuit supports the following single qubit measurement 
gates. 



The 3-qubit gate above was typeset with 
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Command 


Example Code 


— (Basis) 




\meter 
\measure 
\measuretab 
\measureD 


\meter 
\measure{\mbox{Basis}} 


^ M,,, 




\measuretab{M_{ijk}} 


-[D 




\measureD{\chi}- 



Often we want to condition some gate on the output 
of a measurement. One convenient way illustrate this is 
with the classical wire commands, \cw and \cwx. The 
classical wire commands work exactly like the quantum 
wire commands, but they draw double instead of single 
lines. 

Here is an example using measurement gates and clas- 
sical wires and the corresponding code. 



- (Codcbit) 



X 



\Qcircuit (3C=lem (§R=.7em i 

k \qw k \measure{\mbox{Codebit}}- \cwx[l] \\ 

k \qw k \gate-[\chi} & \meter k 
\rstick{\cdots} \cw 
> 

Q-circuit also includes the commands \multimeasure 
and XmultimeasureD for typesetting measurements on 
multiple qubits. The syntax for these commands exactly 
parallels that of the \multigate command (see §IV A). 
An example is shown below. 



Bell 



\Qcircuit (§C=lem @R=.7em i 

k \multimeasureD-[l}-{\text{Bell» \\ 

k \ghost-[\text-[Bell}> 
> 



C. Non-gate inserts, forcing space, and swap 

In addition to the gates defined by Q-circuit, standard 
I^Tj^X can function as a gate if enclosed in curly brack- 
ets. By default, inputs are assumed to have zero size, so 
no space will be made for the resulting object and any 
wires connecting to it will run straight to the object's 
middle. Standard IMJ^X entries can serve as labels or 
wire decorations. 

To force an object to take up space, you should use 
the \push command, \push is most useful in conjunc- 
tion with the I^TfjX command \rule. Together they can 
be used to construct various sorts of invisible props and 
struts. 

Q-circuit implements a gate command called \qswap 
that is equivalent to the text {\times} \qw. The effect 
of \qswap is to insert half of a swap gate (that is a x) 
which can then be connected (using \qwx) to another 
instance of \qswap to create a swap gate. 

Here is a circuit that shows how to construct swap, 
decorate wires, and use \push to make an invisible prop. 

Defective Circuit 
-^ 



\Qcircuit @C=lem @R=.3em -[ 

k k \mbox{Def ective Circuit}\\ 

k \qswap & \qw k \push-[\rule{Oem}-{lem}} \qw \\ 

k \qswap \qwx & \push{X} \qw k \qw \\ 

k {/> \qw k \gate-[H~{\otimes n}} k \qw 



D. How to control anything 

Controlled-Z gates, wires with bends, and gates that 
control-on-zcro can all be made using the extended family 
of control commands. The complete family of control 
commands is \ctrl, \crtlo, \control, and \controlo. 

\ctrlo is identical to the \ctrl command (see §HI B) 
except that it draws an open bullet (indicating control- 
on-zero). Both commands place a wire to the left and 
take one argument indicating which wire to connect to. 

The commands \control and \controlo are isolated 
controls; they don't automatically connect to anything. 
Isolated controls allow you to decide exactly what con- 
nections are made to your control operator, which makes 
them very useful for working with classical wires and ren- 
dering things like the controUcd-Z. 

Here is an example circuit using various controls. 
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\Qcircuit (2C=lem @R=.7em { 

& \ctrl{2} k \ctrlo{l} & \ctrl{l} 

k \qw & \multigate{l}{U} k \qw \\ 
& \qw k \targ k \ctrlo{2} \qw 

k \ctrl{l} & \ghost-[U> k \qw \\ 
& \control \qw & \ctrl{l} & \qw 

k \meter & \controlo \cw \cwx \\ 
& \qw k \control \qw k \gate{H} 

k \meter & \control \cw \cwx 



Note that wc, the authors, have used a pair of controls 
connected by a wire to denote the controlled-Z gate. This 
isn't standard notation, but we feel it is a logically con- 
sistent and concise notation, and it illustrates nicely the 
symmetry of the controlled-Z gate. We hope to encourage 
the readers to adopt this notation in their own QCDs. 



V. BELLS AND WHISTLES: TWEAKING 
YOUR DIAGRAM TO PERFECTION 

By now, the reader should be able to quickly and easily 
typeset almost any QCD. Nonetheless, it may occasion- 
ally be desirable to decorate or modify a circuit in ways 
not yet discussed. This section presents additional tricks, 
options, and commands for putting the final polish on 
your QCDs. 



A. Spacing 

The Q-circuit parameters @R and @C were introduced in 
§111; they are examples of a family of spacing parameters 
that can appear between the text \Qcircuit and the 
opening curly brace. A more complete list of available 
parameters is given in the table below. 



Parameter 


Effect 


@R=#1 


Sets the spacing between rows to #1. 


(§C=#1 


Sets the spacing between columns to #1. 


(§!R 


Sets all rows to the height of the tallest 




object in the circuit. 


@!C 


Sets all columns to the width of the widest 




object in the circuit. 


0! 


Sets all entries to the size of the largest 




object in the circuit. 



The @R and ®C parameters adjust the separation be- 
tween elements, allowing you to dictate the compactness 
of your QCD. @!R, @!C, and (§! force the elements of 
your circuit to have uniform sizes, this helps to prevent 
bunching that may occur when a particular row or col- 
umn contains many small elements. ! R is particularly 
useful for forcing wires to be evenly spaced, as in the 
following example. 



Tt 



\Qcircuit (§C=.7em (9R=.3em @!R ■[ 

& \qswap & \qw & \qswap & \qw\\ 

& \qswap \qwx & \ctrl{l} & \qswap \qwx & \qw \\ 

& \qw & \gate{T"\dag> & \qw k \qw 
> 



B. Labelling 

A label can be placed anywhere that a gate command 
might normally appear. Unlike gates, however, Q-circuit 
treats labels as having zero size when determining the 
layout of a QCD. This prevents large labels from bending 
your circuit out of whack, but it also means that labels 
can overlap with other components. 

Normally an element whose size is set to zero is drawn 
centered on it's entry. This is what happens when you 
insert text directly using curly brackets (see §IVC). For 
most labelling, however, it is more useful to have one edge 
of the label fixed in the center of an entry. For this rea- 
son Q-circuit provides a set of label commands, \lstick, 
\rstick, \ustick, and \dstick. The stick commands 
each cause their contents to "stick out" from the center 
of an entry in a different direction, \lstick, \rstick, 
\ustick, and \dstick produce labels that project out to 
the left, right, top, and bottom respectively. 



Proper usage of \lstick and \rstick was demon- 
strated in §111 D, so the following example focuses on 
\ustick and \dstick. 
a 



A 



\Qcircuit @C=.7em @R=.3em -[ 

& \ustick-[a} \qw & \qw & \qw 



\qw & \meter \\ 



& \ustick{b} \qw & \qw & \qw & \meter \\ 

& & & & \dstick{B} \cwx & \dstick-[A} \cwx[-2] 



C. Grouping 

It is sometimes useful to box off sections of a circuit to 
indicate a subcircuit, as in the following example. 



H 



^^ 



H 
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H 



Z 



which was typeset using 

\Qcircuit (3C=lem @R=lem { 

& \ctrl{2} & \qw & \gate{H} 

\gate{H} & \qw \\ 
k \qw & \ctrl{l> k \gate{H} 

\gate{H} & \qw \\ 
& \targ & \targ k \gate{Z} & 



\ctrl{l} 



\targ 



\qw & \ctrl{-l> 



\qw \gategroup^:l}■{4>{2}{6}{ . 7em}{— } 
} 

The command that made the dashed box is in the last 
line of code and is called \gategroup. The \gategroup 
command can be placed following any non-empty entry, 
but, for clarity, it is perhaps best to put it at the end. 

Because it takes six arguments, \gategroup looks 
intimidating, but it is actually relatively easy to use. 
\gategroup{#l}{#2}{#3}{#4}{#5}{#6} highlights the 
entries between rows #1 and #3 and columns #2 and #4 by 
adding a box or a bracket. Argument #6 selects between 
various highlights, with the available options being: 

— . _\} -\} U \} _)-)() 

These options produce a dashed box, a dotted box, a 
curly brace on the bottom, top, left, or right, and a nor- 
mal brace on the bottom, top, left, or right. Argument 
#5 is twice the spacing from the nearest gate to the box. 
\gategroup only checks that the gates at the four cor- 
ners of the requested region are properly enclosed. As a 
result, gates along the boundary that are bigger than the 
corner gates will tend to stick out. This is especially un- 
sightly when the corner entries are wires, though in that 
case the problem can be fixed by inserting an invisible 
prop of the desired height (see §IVC). 
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APPENDIX A: POSITIONING Q-CIRCUIT 
DIAGRAMS IN I^TfcX 

Q-circuit produces TJ5X graphics objects. In theory 
these objects should act like any symbol or character. 
Thus, they can be placed in equation environments, ar- 
rays, and figures. In practice there are a few, largely 
unexplained, complications. 

One of these is vertical centering in a line of text. To 
center the top line of a circuit, it is sufficient to invoke it 
in inline math mode using $. To center the entire circuit, 
place it inside an array. 

Horizontal centering within figures is also problem- 
atic. Typically this can be corrected by placing the 
\Qcircuit command inside a \centerline command, 
an \mbox command, or an equation environment. For 
some I^TJt;X distributions the commands \leavevmode 
and \centering must be added to center a figure. 

Finally, circuits using large labels often appear a bit 
off center. This is because labels are not included when 
calculating the size of a circuit. The best solution is 
probably to add white space (see §IV C) until the labels 
all fit within the boundaries of the circuit. 



APPENDIX B: BUGS AND FUTURE WORK 

1. Wires often end just short of curved surfaces. 

2. \gategroup needs to check all the boundary gates 
when determining the highlighted area. 

3. Targets look poor when the font size is set to small. 

4. It would be nice if the \ghost command could read 
the argument of the \multigate command auto- 
matically. 

5. Larger issues of centering within I^TJtjX need to be 
addressed. 



APPENDIX C: CODE FOR THE 
INTRODUCTION 

The first QCD depicts a way of decomposing doubly 
controlled unitarics. It was typeset with 



\Qcircuit @C=.5em (§R=Oem @!R ■[ 

& \ctrl{l} & \qw & & & \qw & \ctrl{l} & \qw & 

\ctrl{l} & \ctrl{2} & \qw\\ 
k \ctrl{l} k \qw k 

\push{\rule{ . 3em}-{0em}=\rule{ . 3em}-[0em}} & & 

\ctrl{l} k \targ k \ctrl{l} & \targ & \qw k 

\qw\\ 
& \gate{U} k \qw k k k \gate{V} k \qw k 

\gate{V~\dag}- k \qw k \gate{V} & \qw 
} 



The second QCD depicts quantum teleportation and 
was typeset with 



\Qcircuit (§C=.7em @R=.4em 0! i 

\lstick-[\ket{\psi}-} k \qw k \qw k \ctrl{l} & 

\gate{H} k \meter & \control \cw\\ 
\lstick-[\ket{0}}- k \qw k \targ k \targ k \qw & 

\meter k \cwx\\ 
\lstick-[\ket{0}}- k \gate-[H> k \ctrl{-l} & \qw & 
\qw k \gate-[X}- \cwx k \gate{Z} \cwx & 
\rstick{\ket-[\psi}}- \qw 
} 



The third QCD depicts quantum error correction on 
the bit flip code. It was typeset with 



\Qcircuit (§C=1.3em @R=.6em i 

k k k k k k \mbox{Syndrome Measurement} k k k k 

\mbox{Recovery}-\\ 
k \qw k \qw k \ctrl{3} k \qw k \qw & \qw & 
\ctrl{5} k \qw k \qw k 
\multigate-[2}-{\ \mathcal{R}\ } & \qw\\ 
& \qw k \qw k \qw k \ctrl{2} k \ctrl{3} & \qw & 
\qw & \qw k \qw k \ghost-[\ \mathcal{R}\ } \qw & 
\qw\\ 

fc \qw k \qw k \ctrl-C2> 
\ghost{\ \mathcal{R>\ 



\qw k 
\qw k 



\qw k \qw k \qw 

\ctrl{3} k \qw . 

\qw\\ 

k \lstick{\ket-[0>} k \targ \qw & \targ \qw & 

\qw k \qw k \qw k \qw k \measure{M_a} & 

\control \cw \cwx\\ 

k \lstick{\ket-[0}-} k \qw k \qw k \targ \qw & 

\targ \qw k \qw k \qw k \measure-[M_b}- & 

\control \cw \cwx\\ 

k \lstick{\ket-[0>} k \qw k \qw k \qw k \qw & 

\targ \qw k \targ \qw k \measure{M_c} 

\gategroup-[2>{2}{7}-{10}-{ . 8em}-[— > k 

\control \cw \cwx 



APPENDIX D: TABLE OF COMMANDS 

The following table is grouped according to the effect 
of each command. 



Subj 


ict 


Command 


Loading Q- 


circuit 


\input{Qcircuit} 


Making Cii 


cuits 


\Qcircuit 


Spacing 




@C=#1 
@R=#1 
@!R 

aic 

\push{#l} 


Wires 




\qw[#l] 
\qwx[#l] 
\cw[#l] 
\cwx[#l] 


Gates 




\gate{#l} 

\targ 

\qswap 

\multigate{#l}{#2} 

\ghost{#l} 


Controls 




\ctrl{#l} 
\ctrlo{#l} 
\control 
\controlo 


Measurements 


\meter 






\measure{#l} 






\measureD{#l} 






\measuretab{#l} 






\multimeasure{#l}{#2} 






\multimeasureD{#l}{#2} 


Labels 




\lstick{#l} 

\rstick{#l} 

\ustick{#l} 

\dstick{#l} 

\bra{#l} 

\ket{#l} 

\gategroup{#l}{#2}{#3}{#4}{#5}{#6} 



